home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-13 / cse310.zip / CSE.DOC < prev    next >
Text File  |  1991-01-08  |  11KB  |  231 lines
  1.                             What is CSE?
  2.  
  3. CSE is a tiny editor for MSDOS.  It is designed to take the place of the line
  4. editor, EDLIN, that comes with DOS, by providing a full screen text editor
  5. that is both smaller then EDLIN and far more powerful.
  6.  
  7. CSE is:
  8. small - CSE is under 13K in size, small enough in fact to fit well on a ram
  9.         disk, where it can be found no matter what disk in your dirve on
  10.         floppy based systems!
  11.  
  12. efficient - CSE is written in 8088 structured assembler to run as fast as
  13.             possible
  14.  
  15. powerful - CSE uses all the memory available to DOS (generally 640K) and
  16.            can edit files up to this size or multiple files (up to 16) that
  17.            total a size less than this memory size
  18.            CSE can move, copy, blank, fill, or convert case on blocks of
  19.            data that it is editing
  20.            Keys used to command functions in CSE can be reprogrammed easily
  21.            by the user to make CSE emulate your favorite mainframe editor
  22.            Can handle record lengths up to 255 bytes!
  23.  
  24. versatile - CSE can be used to edit programs, data files, dBase command
  25.             procedures, .BAT files, or any ASCII data
  26.  
  27. BUT CSE IS NOT A WORD PROCESSOR!  CSE lacks formatting, word wrap,
  28. justification, printing, and other attributes of a Word Processor.  CSE
  29. is useful for editing any file that EDLIN would be useful for... if you
  30. want a Word Processor buy Wordstar!
  31.  
  32. MOST OF ALL - CSE IS PUBLIC DOMAIN
  33.  
  34. You may use CSE for any application that you would normally use EDLIN... and
  35. in fact CSE is free software while EDLIN is a product of Microsoft, which
  36. requires the purchase of DOS.
  37.  
  38.                         What do I need to run CSE?
  39.  
  40. CSE will run on any machine running MSDOS 2.0 or above.  It will work on
  41. a monochrome system in black and white, and a color system in color.
  42.  
  43.                              Configuring CSE
  44.  
  45. If CSE and the file PROFILE.CSE are in the current directory, then CSE can
  46. be invoked by typing the command CSE filename, where filename is the name
  47. of the file you want to edit.
  48.  
  49. However, you will probably want to put CSE in a subdirectory that is pathed
  50. such as C:\DOS or C:\BIN.  In fact, CSE can be placed and invoked from any
  51. directory that is listed in the PATH statement found in your AUTOEXEC.BAT.
  52. But in order for CSE to find it's key command profile and it's help file
  53. you must set the environment variable CSE equal to the fully qualified path
  54. to CSE and it's files.
  55.  
  56. If you placed CSE.COM, CSE.HLP, and PROFILE.CSE in your C:\DOS directory then
  57. you need to add the following statement to your AUTOEXEC.BAT:
  58.  
  59. SET CSE=C:\DOS
  60.  
  61. You will then be able to invoke 'CSE filename' from any prompt or drive on
  62. your system.
  63.  
  64. CSE may also be installed on a RAM drive.  This is particularly useful when
  65. running on a lap top or other machine without a hard disk.  Simply install
  66. the ram disk from your boot disk, and then from your autoexec.bat:
  67.  
  68. copy a:cse.com c:
  69. copy a:cse.hlp c:
  70. copy a:profile.cse c:
  71. PATH C:\
  72. SET CSE=c:\
  73.  
  74. This of course assumes that your ram disk installed as C: ... Using CSE in
  75. this fashion only requires a 16K ram disk and gives you instant access to
  76. CSE at any time!
  77.  
  78.                                 Using CSE
  79.  
  80. As mentioned before typing 'CSE filename' will read the file 'filename' into
  81. CSE and display that file in the edit window.  Typing 'CSE' without a filename
  82. will create an unnamed file and place it in the edit window.  From then on
  83. the file may be edicse on the screen.
  84.  
  85. Here are the components of the CSE screen:
  86.  
  87.  
  88. ┌───────────────────────────────────────────────────────────────────────────┐
  89. │                                                                           │
  90. │                                                                           │
  91. │                                                                           │
  92. │                                                                           │
  93. │                                                                           │
  94. │                                                                           │
  95. │                                EDIT WINDOW                                │
  96. │                                                                           │
  97. │                                                                           │
  98. │                                                                           │
  99. │                                                                           │
  100. │                                                                           │
  101. │                                                                           │
  102. │                                                                           │
  103. ├───────────────────────────────────────────────────────────────────────────┤
  104. │                                COMMAND AREA                               │
  105. ├───────────────────────────────────────────────────────────────────────────┤
  106. │                                STATUS LINE                                │
  107. │filename            │ line # │ Column # │ Insert/Replace mode  │ Bytes free│
  108. ├───────────────────────────────────────────────────────────────────────────┤
  109. │                                MESSAGE LINE                               │
  110. └───────────────────────────────────────────────────────────────────────────┘
  111.  
  112. CSE begins with the file specified (or the new blank file if none was specified
  113. in the edit window and the cursor in the COMMAND AREA.  A blinking cursor in
  114. the edit window tells you where the edit cursor is located.  You may toggle
  115. back and forth from the EDIT WINDOW to the COMMAND AREA by hitting the ESC key.
  116. While in the COMMAND AREA there are several command you may enter:
  117.  
  118. C or CHANGE /search/replace/
  119.  
  120. search and replace are strings encased in slashes (the delimiter) for CSE to
  121. search and replace!  You will be prompcse to confirm any change before it is
  122. performed by hitting the CONFIRM key (F10)
  123.  
  124. DEFINE keyname = [function] 'literal'
  125.  
  126. This can be used to change the definition of any key.  A document listing the
  127. names of all keys and the name and function of all commands will be sent to
  128. any registered user who requests it!
  129.  
  130. This command is typically used in the PROFILE.CSE file to reconfigure keys
  131.  
  132. DOS
  133.  
  134. Loads and Executes a copy of COMMAND.COM, allowing you to break out of
  135. CSE temporarily to run another program.  You may return to CSE by typing
  136. EXIT at any DOS prompt.
  137.  
  138. DIR
  139.  
  140. Displays a file named DIR.DIR that contains a copy of the default directory.
  141.  
  142. E or EDIT filename
  143.  
  144. This will clear the screen and load the specified document into the editor.
  145. Multiple files can be switched into and out of the EDIT WINDOW with the
  146. SWITCH FILES key.
  147.  
  148. L or LOCATE /search/
  149.  
  150. Works similar to CHANGE except no replace string is needed and no change
  151. if performed... but the edit cursor is moved to the location of the found
  152. string.
  153.  
  154. MACRO filename - used to define keys
  155.  
  156. Used to load and execute a macro file containing commands or settings...
  157. The creation of a macro file is covered in the document ADVANCED.DOC which
  158. is available only to registered users.
  159.  
  160. NAME filename - used to change name
  161.  
  162. Changes the name of a file so that when it is saved it has a different name!
  163. Required if you invoked CSE without a file name and want to save what you
  164. typed!
  165.  
  166. SET setting = 'litteral'
  167.  
  168. Various options such as color, tab settings, and save options may be set
  169. with the SET command.  This usually occurs in the PROFILE.CSE macro or in
  170. a macro invoked with the macro command.  This command and it's use is also
  171. discussed in ADVANCED.DOC which is available only to registered users!
  172.  
  173. The following function keys and command keys have been set by the macro file,
  174. PROFILE.CSE, which loads and executes everytime CSE is run:
  175.  
  176.                    A+ = ALT +                 C+ = CTRL+
  177.  
  178.    ╔════╗ ╔════╗  ╔════╗  ╔════╗  ╔════╗  ╔════╗  ╔════╗  ╔════╗  ╔════╗  ╔════╗
  179.    ║ F1 ║ ║ F2 ║  ║ F3 ║  ║ F4 ║  ║ F5 ║  ║ F6 ║  ║ F7 ║  ║ F8 ║  ║ F9 ║  ║ F10║
  180.    ╚════╝ ╚════╝  ╚════╝  ╚════╝  ╚════╝  ╚════╝  ╚════╝  ╚════╝  ╚════╝  ╚════╝
  181.    HELP    SAVE    FILE    QUIT    EDIT   SWITCH    DOS     DIR  EXECUTE CONFIRM
  182. C+ MARK  MARK LINE COPY    MOVE   DELETE   FILL   UPCASE LOWCASE          UNMARK
  183. A+ +LINE  ERASE ERASE END -LINE    SPLIT   JOIN                   REDRAW  ESCAPE
  184.  
  185.   Backspace = Delete char to left          Up           = Up
  186.   Tab       = Move cursor to next stop     Down         = Down
  187.   Shift-Tab = Move cursor to prev stop     Left         = Left
  188.   Insert    = Toggle insert/replace        Right        = Right
  189.   Esc       = Toggle command/edit mode     Home         = Top of Screen
  190.   Delete    = Delete current character     End          = Bottom of Screen
  191.   PgUp      = Move back one screen         Ctrl-PgUp    = Top of File
  192.   PgDown    = Move forward one screen      Ctrl-PgDown  = Bottom of File
  193.  
  194.   Alt-B = Mark corner of block
  195.   Alt-L = Mark line of block
  196.   Alt-C = Copy marked block
  197.   Alt-D = Delete marked block
  198.   Alt-F = Fill Block
  199.   Alt-U = Unmark block
  200.   Alt-I = Add line after this line
  201.   Alt-S = Split line at cursor
  202.   Alt-J = Join line with next line
  203.  
  204.                               Block Editing
  205.  
  206. There are two ways to mark blocks in CSE.  The top and bottom of a block may be
  207. marked with Ctrl-F1 or Alt-B... this square block may or may not contain all
  208. of a line, and will only cover a portion of a line when moved or copied.  The
  209. Ctrl-F2 or Alt-L keys will mark a single entire line or a range of lines.  When
  210. Alt-L is first hit it marks the start of a block and when it is hit again it
  211. marks the end of the block and all lines in between will be marked as selected!
  212.  
  213. Whenever a block has been marked it must be unmarked (Ctrl-F10 or Alt-U) before
  214. another block may be marked!
  215.  
  216. Marked blocks may moved or copied between files by marking them in one file,
  217. switching to the other file with the SWITCH key, and copying or moveing.
  218.  
  219. -------------------------------------------------------------------------------
  220.  
  221. While CSE may be used for any editing application, and may be distributed
  222. freely to your freinds, coworkers, and anyone else who needs an editor you
  223. may not distribute it for money, you may not charge even a copying fee for
  224. CSE... CSE is and must remain specifically FREE for all.  If you desire to
  225. distribute CSE with your application, feel free... but do not charge anymore
  226. for CSE!
  227.  
  228. CSE may be freeware, but it is still copyrighted material.  You may not know
  229. who I am, but if I find you using CSE for your own material gain, then you
  230. will certainly hear from my attorney.
  231.